package com.danciyixue.boot.dcyx.service;

import com.danciyixue.boot.client.test.model.UnitTestItem;
import com.danciyixue.boot.client.test.model.UnitTestQuery;
import com.danciyixue.boot.dcyx.model.entity.Tests;
import com.danciyixue.boot.dcyx.model.form.TestsForm;
import com.danciyixue.boot.dcyx.model.query.TestsQuery;
import com.danciyixue.boot.dcyx.model.vo.TestsVO;
import com.danciyixue.boot.dcyx.model.vo.PreTestVO;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;

/**
 * 测试试卷信息服务类
 *
 * @author youlaitech
 * @since 2025-06-15 16:21
 */
public interface TestsService extends IService<Tests> {

    /**
     *测试试卷信息分页列表
     *
     * @return {@link IPage<TestsVO>} 测试试卷信息分页列表
     */
    IPage<TestsVO> getTestsPage(TestsQuery queryParams);

    /**
     * 获取测试试卷信息表单数据
     *
     * @param id 测试试卷信息ID
     * @return 测试试卷信息表单数据
     */
     TestsForm getTestsFormData(Long id);

    /**
     * 新增测试试卷信息
     *
     * @param formData 测试试卷信息表单对象
     * @return 是否新增成功
     */
    boolean saveTests(TestsForm formData);

    /**
     * 修改测试试卷信息
     *
     * @param id   测试试卷信息ID
     * @param formData 测试试卷信息表单对象
     * @return 是否修改成功
     */
    boolean updateTests(Long id, TestsForm formData);

    /**
     * 删除测试试卷信息
     *
     * @param ids 测试试卷信息ID，多个以英文逗号(,)分割
     * @return 是否删除成功
     */
    boolean deleteTestss(String ids);

    /**
     * 获取学前测试
     *
     * @param programId 教材ID
     * @return 学前测试数据
     */
    PreTestVO getPreTest(Long programId);

    /**
     * 获取学前测试
     *
     * @param programId 教材ID
     * @param shuffle 是否重新生成试卷
     * @return 学前测试数据
     */
    PreTestVO getPreTest(Long programId, Boolean shuffle);

    /**
     * 获取单元测试项列表
     *
     * @param queryParams 查询参数
     * @return 单元测试项分页列表
     */
    IPage<UnitTestItem> getUnitTestItems(UnitTestQuery queryParams);

    /**
     * 获取单元测试试卷内容
     *
     * @param unitId 单元ID
     * @param shuffle 是否重新生成试卷
     * @return 单元测试数据
     */
    PreTestVO getUnitTest(Long unitId, Boolean shuffle);

}
